home *** CD-ROM | disk | FTP | other *** search
/ Precision Software Appli…tions Silver Collection 1 / Precision Software Applications Silver Collection Volume One (PSM) (1993).iso / windows / games / nilbuild.arj / NILBUILD.DOC next >
Text File  |  1993-01-13  |  5KB  |  101 lines
  1. NILBUILD.DOC -- Documentation for NILBUILD.WBT; an .NIL library builder for 
  2. ============    the Norton Desktop Icon Editor
  3.  
  4. PROGRAM AUTHOR - Bob Staudenmaier (805)685-4751 voice/fax
  5. ==============
  6.  
  7. SYSTEM REQUIREMENTS
  8. =================== 
  9. User must have the Norton Desktop for Windows, including BATCHRUN and 
  10. ICONEDIT, installed on his system.  Also, a collection of .ICO files is 
  11. necessary to build the library.  These are available from just about any BBS.  
  12. Also, many software packages, such as "Visual Basic", come with substantial 
  13. icon collections.
  14.  
  15. PROBLEM
  16. =======
  17. The Norton Icon Editor is very convenient in that it allows users to import
  18. groups of icons into individual files called .NIL libraries. The user 
  19. can then quickly "scan" large groups of icons by using ICONEDIT, or by 
  20. dropping the .NIL file onto the Norton Viewer icon.  Directory space is also 
  21. conserved.  
  22.  
  23. However, ICONEDIT allows the user to import only ONE icon at a time!  Each 
  24. icon requires 6 mouse clicks.  Therefore, building a "modest" library of, say
  25. 100 icons, can take several hours!
  26.  
  27. SOLUTION
  28. ======== 
  29. NILBUILD is a simple program written in the Norton Batch-Runner language.  
  30. When run, it asks the user for the name of the .NIL library to import to.  It 
  31. then launches ICONEDIT and asks for the name of the directory where the .ICO 
  32. files are kept.  It then imports every .ICO file from that directory by 
  33. sending "keystrokes" to ICONEDIT.  This is a relatively slow process by 
  34. computer standards, but it can build a 100 icon library in just a few minutes!
  35.  
  36. PROCEDURE
  37. =========
  38. Copy NILBUILD.WBT to whichever directory you normally keep your batch programs 
  39. in.  You should be able to launch NILBUILD by double-clicking on it in the 
  40. drive window.  If not, you will have to make an association between the .WBT 
  41. extension and the BATCHRUN.EXE program. (see 6-14 in the NDW User's Manual)  
  42. If you want to get fancy, you can drag NILBUILD.WBT out of the drive window 
  43. and into a program group window.  The "Batch Runner" (man running!) icon 
  44. should appear if the association has been made correctly.  You can then 
  45. optionally substitute the NILBUILD.ICO icon (supplied) by using the PROPERTIES 
  46. command in the FILE menu on the desktop.
  47.  
  48. When NILBUILD runs, it asks first for the name of the .NIL library file you 
  49. want to import to.  This file MUST exist already, even if it is empty.  If 
  50. this is a NEW library you are making, use ICONEDIT to create it first.  You 
  51. must also enter the COMPLETE pathname, including the .NIL extension, of the 
  52. library.  If you want, you can use the default, which is C:\NDW\ICONLIB.NIL, 
  53. or change the default by modifying the NILBUILD.WBT source code with DESKEDIT 
  54. or NOTEPAD.  Modifiable defaults are clearly marked at the beginning of the 
  55. program.
  56.  
  57. NILBUILD will then launch ICONEDIT and load the .NIL library into it.  It will 
  58. then prompt the user for the complete pathname of the directory where the .ICO 
  59. files are kept.  The default is C:\ICONS, but this is also modifiable in the 
  60. source code.  Be careful!!  NILBUILD will try to import EVERY .ICO file in the 
  61. specified directory.  If you have the "HIDE BATCH RUNNER ICON" box in the 
  62. desktop CONFIGURE menu checked, there will be no way to stop it!!  Luckily, 
  63. though, NILBUILD leaves the ICONEDIT window open after it finishes, so you can 
  64. go in and make deletions if you import too many.  You can also close the 
  65. ICONEDIT window, without saving the library, and start over.  If you DO want 
  66. to keep all the icons you imported, you must save the .NIL library before 
  67. closing the Icon Editor window.
  68.  
  69. When NILBUILD finishes, it will either report NO errors, or a present a list 
  70. of .ICO files that couldn't be read.  Don't delete these icons!!  They can 
  71. often be repaired!! (see NOTES section following)
  72.  
  73. NOTES
  74. =====
  75.  
  76. 1) Don't walk away after you start NILBUILD! It can be fun to watch.
  77.  
  78. 2) NILBUILD assumes that ICONEDIT.EXE is stored in the C:\NDW directory.  If 
  79.    it is not, you must change the default NDW directory at the beginning of 
  80.    the source code.
  81.  
  82. 3) The Norton Icon Editor consumes a tremendous percentage of system GDI 
  83.    resources, regardless of available memory.  Therefore, if an .NIL file 
  84.    becomes too large, it can become unreadable under common system demands;
  85.    even on BIG systems!  I recommend that you try to keep .NIL file size 
  86.    down to 325,000 bytes or less.
  87.  
  88. 4) I have found that approximately 5% of all icons found on bulletin boards 
  89.    contain an "irregularity" that prevents them from being read by the Norton 
  90.    Icon Editor, even though they can be read by the Norton Viewer and other 
  91.    editors.  If you encounter this fairly often, download NFIXICON.EXE from 
  92.    the Symantec BBS at (408)973-9834 (9600 baud) or (408)973-9598 (2400 baud).
  93.    NFIXICON is a DOS program that removes this irregularity from .ICO files 
  94.    while leaving the intended picture unchanged.  It works on about 95% of all 
  95.    unreadable icons.
  96.  
  97.                                                             Bob Staudenmaier
  98.                                                                 1/14/93
  99.  
  100.  
  101.